<?php  if ( ! defined('BASEPATH')) exit('禁止直接访问脚本目录！');
/**
 * CodeIgniter
 *
 * 这是一个PHP开源程序开发框架，要求PHP 5.1.6+
 *
 * @package		CodeIgniter
 * @author		ExpressionEngine Dev Team
 * @copyright	Copyright (c) 2008 - 2011, EllisLab, Inc.
 * @license		http://codeigniter.com/user_guide/license.html
 * @link		http://codeigniter.com
 * @since		Version 1.0
 * @filesource
 */

// ------------------------------------------------------------------------

/**
 * 全局函数
 *
 * 加载基类并执行请求。
 *
 * @package		CodeIgniter
 * @subpackage	codeigniter
 * @category	Common Functions
 * @author		ExpressionEngine Dev Team
 * @link		http://codeigniter.com/user_guide/
 */

// ------------------------------------------------------------------------

/**
* 判断PHP当前版本是否高于所要求的值
*
* 有些地方要求PHP>5，因此我们设置一个静态变量以便随时判断
*
* @access	public
* @param	string
* @return	bool	TRUE 当前版本等于或高于$version时返回值
*/
if ( ! function_exists('is_php'))
{
	function is_php($version = '5.0.0')
	{
		static $_is_php;
		$version = (string)$version;

		if ( ! isset($_is_php[$version]))
		{
			$_is_php[$version] = (version_compare(PHP_VERSION, $version) < 0) ? FALSE : TRUE;
		}

		return $_is_php[$version];
	}
}

// ------------------------------------------------------------------------

/**
 * 检测文件是否可写
 *
 * 注意，在Windows服务器的只读属性下面，is_writable()会返回TRUE，这是十分不可靠的。
 * 另外，在Unix的安全模式下面这个函数同样是靠不住的。
 *
 * @access	private
 * @return	void
 */
if ( ! function_exists('is_really_writable'))
{
	function is_really_writable($file)
	{
		// 如果处于Unix服务器上，并且安全模式关闭，则执行is_writable函数
		if (DIRECTORY_SEPARATOR == '/' AND @ini_get("safe_mode") == FALSE)
		{
			return is_writable($file);
		}

		// 在Windows服务器上或者是安全模式开启的情况，我们只有亲自尝试一下了。
		if (is_dir($file))
		{
			$file = rtrim($file, '/').'/'.md5(mt_rand(1,100).mt_rand(1,100));

			if (($fp = @fopen($file, FOPEN_WRITE_CREATE)) === FALSE)
			{
				return FALSE;
			}

			fclose($fp);
			@chmod($file, DIR_WRITE_MODE);
			@unlink($file);
			return TRUE;
		}
		elseif ( ! is_file($file) OR ($fp = @fopen($file, FOPEN_WRITE_CREATE)) === FALSE)
		{
			return FALSE;
		}

		fclose($fp);
		return TRUE;
	}
}

// ------------------------------------------------------------------------

/**
* 类注册
*
* 检测被请求的类是否已经注册，如果没有，则对该类进行实例化并赋值给一个静态
* 变量完成类的注册。如果被请求的类已经被实例化了，则直接返回实例化之后的变
* 量。
*
* @access	public
* @param	string	被请求的类名称
* @param	string	被请求类的目录
* @param	string	被请求类名的前缀
* @return	object
*/
if ( ! function_exists('load_class'))
{
	function &load_class($class, $directory = 'libraries', $prefix = 'CI_')
	{
		static $_classes = array();

		// 如果类已经注册则直接返回实例化之后的变量
		if (isset($_classes[$class]))
		{
			return $_classes[$class];
		}

		$name = FALSE;

		// 先在application/libraries文件夹下面寻找该类，然后才会在system/libraries
		// 文件夹中寻找
		foreach (array(APPPATH, BASEPATH) as $path)
		{
			if (file_exists($path.$directory.'/'.$class.'.php'))
			{
				$name = $prefix.$class;

				if (class_exists($name) === FALSE)
				{
					require($path.$directory.'/'.$class.'.php');
				}

				break;
			}
		}

		// 如果请求的是一个扩展的类，也同样进行加载
		if (file_exists(APPPATH.$directory.'/'.config_item('subclass_prefix').$class.'.php'))
		{
			$name = config_item('subclass_prefix').$class;

			if (class_exists($name) === FALSE)
			{
				require(APPPATH.$directory.'/'.config_item('subclass_prefix').$class.'.php');
			}
		}

		// 判断是否找到了被请求的类
		if ($name === FALSE)
		{
			// 提示：此处使用exit()而不是show_error()是为了避免用show_error()时又调用本函数产生
			// 死循环。(分析：假如show_error()所依托的Excptions类不存在，而此时恰好请求Excptions
			// 类，执行到此处的时候show_error()又会要求加载Excptions类，如此死循环就产生了。具体
			// 请切换到show_error()函数查看其实现方式。)
			exit('无法加载指定的类: '.$class.'.php');
		}

		// 对被请求的类名进行注册(注册为静态变量)
		is_loaded($class);

		$_classes[$class] = new $name();
		return $_classes[$class];
	}
}

// --------------------------------------------------------------------

/**
* 此处对已被成功加载的被请求的类进行注册。该函数会被上面的load_class()函数
* 所调用。这些被成功加载的类名，会被注册到一个静态数组当中。
* 
* @access	public
* @return	array
*/
if ( ! function_exists('is_loaded'))
{
	function is_loaded($class = '')
	{
		static $_is_loaded = array();

		if ($class != '')
		{
			$_is_loaded[strtolower($class)] = $class;
		}

		return $_is_loaded;
	}
}

// ------------------------------------------------------------------------

/**
* 加载主config.php文件
*
* 该函数允许我们先于Config类实例化之前对配置文件进行操作。
*
* @access	private
* @return	array
*/
if ( ! function_exists('get_config'))
{
	function &get_config($replace = array())
	{
		static $_config;

		if (isset($_config))
		{
			return $_config[0];
		}

		// 判断配置文件时候位于自定义的系统环境文件夹中
		if ( ! defined('ENVIRONMENT') OR ! file_exists($file_path = APPPATH.'config/'.ENVIRONMENT.'/config.php'))
		{
			$file_path = APPPATH.'config/config.php';
		}

		// 引入配置文件
		if ( ! file_exists($file_path))
		{
			exit('配置文件不存在！');
		}

		require($file_path);

		// 判断是否存在$config数组
		if ( ! isset($config) OR ! is_array($config))
		{
			exit('配置文件没有遵照正确的格式进行设置。');
		}

		// 如有需要，动态增加或者替换某些配置项
		if (count($replace) > 0)
		{
			foreach ($replace as $key => $val)
			{
				if (isset($config[$key]))
				{
					$config[$key] = $val;
				}
			}
		}

		return $_config[0] =& $config;
	}
}

// ------------------------------------------------------------------------

/**
* 返回指定的配置项目
*
* @access	public
* @return	mixed
*/
if ( ! function_exists('config_item'))
{
	function config_item($item)
	{
		static $_config_item = array();

		if ( ! isset($_config_item[$item]))
		{
			$config =& get_config();

			if ( ! isset($config[$item]))
			{
				return FALSE;
			}
			$_config_item[$item] = $config[$item];
		}

		return $_config_item[$item];
	}
}

// ------------------------------------------------------------------------

/**
* 错误处理
*
* 该函数使得我们可以用Exceptions类来调用一套标准的错误模板来显示错误。该错误模板
* 位于application/errors/errors.php
* 该函数将直接把错误页面发送给浏览器并且退出程序。
*
* @access	public
* @return	void
*/
if ( ! function_exists('show_error'))
{
	function show_error($message, $status_code = 500, $heading = 'An Error Was Encountered')
	{
		$_error =& load_class('Exceptions', 'core');
		echo $_error->show_error($heading, $message, 'error_general', $status_code);
		exit;
	}
}

// ------------------------------------------------------------------------

/**
* 404 错误处理
*
* 该函数有点类似于show_error()函数，不过不同于前者使用错误模板来显示。这里只用
* 404错误来代替。
*
* @access	public
* @return	void
*/
if ( ! function_exists('show_404'))
{
	function show_404($page = '', $log_error = TRUE)
	{
		$_error =& load_class('Exceptions', 'core');
		$_error->show_404($page, $log_error);
		exit;
	}
}

// ------------------------------------------------------------------------

/**
* 错误日志接口
*
* 该函数提供一个简单的访问日志类并进行错误记录的方法
*
* @access	public
* @return	void
*/
if ( ! function_exists('log_message'))
{
	function log_message($level = 'error', $message, $php_error = FALSE)
	{
		static $_log;

		if (config_item('log_threshold') == 0)
		{
			return;
		}

		$_log =& load_class('Log');
		$_log->write_log($level, $message, $php_error);
	}
}

// ------------------------------------------------------------------------

/**
 * 设置HTTP状态头信息
 *
 * @access	public
 * @param	int		状态代码
 * @param	string
 * @return	void
 */
if ( ! function_exists('set_status_header'))
{
	function set_status_header($code = 200, $text = '')
	{
		$stati = array(
							200	=> 'OK',
							201	=> 'Created',
							202	=> 'Accepted',
							203	=> 'Non-Authoritative Information',
							204	=> 'No Content',
							205	=> 'Reset Content',
							206	=> 'Partial Content',

							300	=> 'Multiple Choices',
							301	=> 'Moved Permanently',
							302	=> 'Found',
							304	=> 'Not Modified',
							305	=> 'Use Proxy',
							307	=> 'Temporary Redirect',

							400	=> 'Bad Request',
							401	=> 'Unauthorized',
							403	=> 'Forbidden',
							404	=> 'Not Found',
							405	=> 'Method Not Allowed',
							406	=> 'Not Acceptable',
							407	=> 'Proxy Authentication Required',
							408	=> 'Request Timeout',
							409	=> 'Conflict',
							410	=> 'Gone',
							411	=> 'Length Required',
							412	=> 'Precondition Failed',
							413	=> 'Request Entity Too Large',
							414	=> 'Request-URI Too Long',
							415	=> 'Unsupported Media Type',
							416	=> 'Requested Range Not Satisfiable',
							417	=> 'Expectation Failed',

							500	=> 'Internal Server Error',
							501	=> 'Not Implemented',
							502	=> 'Bad Gateway',
							503	=> 'Service Unavailable',
							504	=> 'Gateway Timeout',
							505	=> 'HTTP Version Not Supported'
						);

		if ($code == '' OR ! is_numeric($code))
		{
			show_error('状态代码只能是数字', 500);
		}

		if (isset($stati[$code]) AND $text == '')
		{
			$text = $stati[$code];
		}

		if ($text == '')
		{
			show_error('没有可用的状态文本。请检测状态代码或提供自定义的信息文本', 500);
		}

		$server_protocol = (isset($_SERVER['SERVER_PROTOCOL'])) ? $_SERVER['SERVER_PROTOCOL'] : FALSE;

		if (substr(php_sapi_name(), 0, 3) == 'cgi')
		{
			header("Status: {$code} {$text}", TRUE);
		}
		elseif ($server_protocol == 'HTTP/1.1' OR $server_protocol == 'HTTP/1.0')
		{
			header($server_protocol." {$code} {$text}", TRUE, $code);
		}
		else
		{
			header("HTTP/1.1 {$code} {$text}", TRUE, $code);
		}
	}
}

// --------------------------------------------------------------------

/**
* 异常处理
*
* 此为自定义异常处理程序，在Codeigniter.php的72行进行了声明 。用这个函数的主要
* 原因是，允许在我们自己的日志文件中记录PHP错误，因为用户可能没有访问服务器日志
* 的权限。由于此功能会拦截PHP错误，我们需要另外的方法来显示出错误。这里我们使用
* PHP错误模板的方式来显示。
*
* @access	private
* @return	void
*/
if ( ! function_exists('_exception_handler'))
{
	function _exception_handler($severity, $message, $filepath, $line)
	{
		 // 我们不会干预'严格'方面的提示信息，因为严格模式下面会产生很多没有必要的提示
		 // 信息，对我们的帮助不是很大。(例如：在PHP5以后的版本由于没有声明类函数的级别
		 // 如public、private等所产生的提示，实际上这种提示没多大用处)
		if ($severity == E_STRICT)
		{
			return;
		}

		$_error =& load_class('Exceptions', 'core');

		// 我们会将当前的错误级别和要求报告的级别相比较，以便确定是否对错误信息进行显示
		if (($severity & error_reporting()) == $severity)
		{
			$_error->show_php_error($severity, $message, $filepath, $line);
		}

		// 如果配置选项种要求不进行日志记录，则直接返回
		if (config_item('log_threshold') == 0)
		{
			return;
		}

		$_error->log_exception($severity, $message, $filepath, $line);
	}
}

// --------------------------------------------------------------------

/**
 * 删除不可见字符
 *
 * 该函数可以删除位于ASCII字符夹缝中的空字符，例如：Java\0script
 * (注：\0为字符串结束标识符)
 *
 * @access	public
 * @param	string
 * @return	string
 */
if ( ! function_exists('remove_invisible_characters'))
{
	function remove_invisible_characters($str, $url_encoded = TRUE)
	{
		$non_displayables = array();
		
		// 删除除了 换行 (dec 10) 回车 (dec 13) 水平制表符 (dec 09)外的所有
		// 控制字符
		if ($url_encoded)
		{
			$non_displayables[] = '/%0[0-8bcef]/';	// url encoded 00-08, 11, 12, 14, 15
			$non_displayables[] = '/%1[0-9a-f]/';	// url encoded 16-31
		}
		
		$non_displayables[] = '/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]+/S';	// 00-08, 11, 12, 14-31, 127

		do
		{
			$str = preg_replace($non_displayables, '', $str, -1, $count);
		}
		while ($count);

		return $str;
	}
}

// ------------------------------------------------------------------------

/**
* HTML特殊符号转义
*
* @access	public
* @param	mixed
* @return	mixed
*/
if ( ! function_exists('html_escape'))
{
	function html_escape($var)
	{
		if (is_array($var))
		{
			return array_map('html_escape', $var);
		}
		else
		{
			return htmlspecialchars($var, ENT_QUOTES, config_item('charset'));
		}
	}
}

/* End of file Common.php */
/* Location: ./system/core/Common.php */